home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / cread211.zip / READ.ENG < prev    next >
Text File  |  1994-01-14  |  19KB  |  439 lines
  1.                              READ - A Text Browser
  2.                              =====================
  3.  
  4.                 (Siehe READ.DEU für deutsche Dokumentation)
  5.  
  6.  
  7. 0. Why READ?
  8. ------------
  9.  
  10. Archives, Public Domain disks and other software is often shipped with
  11. ready-to-print documentation (like this file); you just have to send it
  12. to your printer... and then you've got 100 sheets of paper less, and
  13. ribbons or toner cartridges cost money, too. So it's advisable to have
  14. a look at the documentation file first, maybe you don't need it printed.
  15. Just type TYPE PROGRAM.DOC | more <┘. But what was that just one screen
  16. ago? ****, same procedure again. Well, that's really not comfortable.
  17. You might say: 'Well, I've got a README.EXE or LIST.EXE (or something)
  18. to read texts.' Fine. Ever tried to read texts that are formatted with
  19. more than 80 columns? Sure, you can scroll horizontally, but maybe your
  20. video adapter is capable of some extended text modes... even if the
  21. manual doesn't specify them... READ.EXE uses them!
  22.  
  23. Text files often contain formfeed characters. Does your lister show them
  24. as a female sign, or does it show clear page separation? Can you leap
  25. page-wise through your text? Does your browser recognize the longest line
  26. on screen and scrolls horizontally as far as necessary to display the right-
  27. most character?
  28.  
  29. Does your lister recognize typical text files if you don't specify
  30. them?
  31.  
  32. Can your lister be used as a replacement for MORE? Can it accept data
  33. piped in from another program?
  34.  
  35. Does your lister understand UNIX files (without CR in front of LF)?
  36.  
  37. Is your browser able to show text files with different charsets? Especially
  38. ISO-8859-1?
  39.  
  40. Can your lister be fully operated with a mouse?
  41.  
  42. Is your lister capable of bookmark features?
  43.  
  44.  
  45. Well, I hope you're convinced that READ is just what you've always wanted.
  46.  
  47.  
  48.  
  49. 1. Requirements
  50. ---------------
  51.  
  52. READ is fairly modest. It gets along with about 120k of memory, and it's
  53. already fast enough on an XT. Nearly every graphics card is supported, even
  54. in its special modes. DOS 3.xx is required, DOS 5.xx or 6.xx advisable. A
  55. hard disk is not needed. In DesqView(tm), READ runs in an 128k window if
  56. you zoom it; when idle, READ does not consume any considerable amount of
  57. CPU time in multitasking environments like DesqView and Windows.
  58.  
  59. [DesqView is a registered trademark of Quarterdeck Office Systems.
  60. Windows is a registered trademark of Microsoft Corp.]
  61.  
  62.  
  63.  
  64. 2. How to start READ
  65. --------------------
  66.  
  67. Simply specify one or more filenames on the command line, eg.
  68.  
  69.      READ *.TXT *.DOC 
  70.  
  71. The only switch available is /S; if specified, READ takes its input from
  72. STDIN rather than files. This allows you to 'pipe in' text:
  73.  
  74.      DIR | READ /S
  75.      READ /S <text
  76.  
  77. If you didn't specify a unique file name (maybe you used wildcards), READ
  78. offers you a list of possible files (max. 128), from which you choose one
  79. with the cursor keys, PgUp, PgDn, Home, End, and Enter. Use Del to remove
  80. files from the list, or add others with Ins (of course you can give one
  81. or more templates at a time!). Abort READ with Q or Esc.
  82.  
  83. If you like to, you can sort the file list alphabetically or according to
  84. file size. Just press A, Shift-A, S or Shift-S.
  85.  
  86. You can also select a file with your mouse. Hold down the left button, then
  87. move mouse until the wished file is highlighted, then release the left button
  88. (to lock the mouse) and press the right button. If you press both buttons,
  89. READ quits.
  90.  
  91. Save the file data with W if you want to quit READ and continue reading later
  92. on. READ notes down all chosen files, all your bookmarks and other info
  93. (the charset you used, where you were reading, etc.) and allows you to read
  94. back this info by pressing R.
  95.  
  96.  
  97.  
  98. 3. How to move round in your text
  99. ---------------------------------
  100.  
  101. Use the cursor keys to scroll one line up/down or some characters left/right.
  102. Ctrl & cursor left/right uses an alternate stepsize (see configuration).
  103. PgUp/PgDn jumps one screen page up or down, Ctrl-PgUp/PgDn jumps to the
  104. nearest formfeed character in the text or to the text start/end if there are
  105. none. If you wish to jump directly to the text start/end, press Ctrl-Home/End.
  106. Home/End does the same as with your full-screen editor: it aligns the screen
  107. in a way that allows you to see the leftmost/rightmost character of the
  108. longest line on screen. Q quits immediately, Esc takes you back to the file
  109. selection.
  110.  
  111. A special feature is the space bar: it moves to the next formfeed character
  112. if there's not more than one screen page to go; Otherwise, it acts like the
  113. PgDn key.
  114.  
  115. You can also move round with your mouse. See the chapter on mouse
  116. configuration.
  117.  
  118. Of course you can call DOS at any time: just press Alt-Z. Make sure you don't
  119. install any memory-resident programs. EXIT takes you back to READ; READ
  120. normally occupies 55k of memory when swapping to DOS, but just 20k if
  121. you have XMS or EMS memory (eg. you installed HIMEM.SYS, EMM386.SYS or
  122. QEMM386.SYS).
  123.  
  124. Searching for a key-word? Press F to specify one; press N to search again. The
  125. search is case-insensitive, as long as you don't press Shift-F instead of F.
  126.  
  127. Do you wish to drop bookmarks? Of course you can! Use Alt-1 to Alt-0 to mark
  128. positions within the text, then jump to those positions with 1 to 0.
  129.  
  130. READ remembers the current location and the bookmarks if you choose to read
  131. another text in the meantime. Bookmarks are text-specific!
  132.  
  133. You want to jump to a specific line? Type G, then enter the line number! This
  134. may take awhile since READ must count the lines from the beginning of the
  135. text.
  136.  
  137. If you type Shift-G, READ calculates the line number of the upmost line on the
  138. screen and the total number of lines. With long files, this may take some
  139. seconds.
  140.  
  141. Of course you can abandon functions that take a while by pressing Esc. If you
  142. hit Q instead, READ quits immediately.
  143.  
  144.  
  145.  
  146. 4. How to influence the text display
  147. ------------------------------------
  148.  
  149. Well, READ makes use of up to twelve screen modes that can be selected with
  150. F1 to F12, but they have to be defined first (see later on).
  151.  
  152. Then you can freely choose foreground and background color: use < and > for
  153. the foreground color and ( and ) for the background color.
  154.  
  155. Are there Tab characters within the text that don't refer to 8 colums margins?
  156. Adjust the tab spacing with T and Shift-T.
  157.  
  158. Does your text make use of the ISO-8859-1 charset? Select a charset with C.
  159.  
  160. Is your text taken from the Usenet and coded ROT13? Type R.
  161.  
  162. Don't you like the elevator bar to the right? Toggle it on/off with E.
  163.  
  164. Your text is narrow compared to the screen wide? Indent or unindent with I
  165. and Shift-I.
  166.  
  167. You prefer long lines to be wrapped-around rather than shifting the screen
  168. window horizontally? Switch to wrap-around mode with W. Note that one line
  169. is still one line internally, even if it is splitted into ten! But if
  170. you put a line "W 0 1" in your config file, READ tries to estimate the
  171. start of the screen lines in your text when you scroll back in wrap-
  172. around mode (without putting you in it at first, of course).
  173.  
  174.  
  175.  
  176. 5. Is that all?
  177. ---------------
  178.  
  179. No. READ is capable of printing, cutting and catenating text parts; charset
  180. conversions and ROT13 are taken into account if you wish.
  181.  
  182. Type P to select Printing. Then select a start and an end (READ offers you
  183. a list of salient points that can be used) and choose if the text in-between
  184. is to be sent to a printer port or to be written/appended to a file. Of course
  185. you can abort printing at any time with Esc. If you wrote the text to a file
  186. that is not already in the file selection list, READ suggests it to be added.
  187. Of course you may add or remove CRs...
  188.  
  189.  
  190.  
  191. 6. Am I to remember all these keys?!
  192. ------------------------------------
  193.  
  194. No, of course not. Just one: H. It displays a help screen.
  195.  
  196.  
  197.  
  198. 7. Well, READ is rather cute, but I don't like XXXXX. 
  199. -----------------------------------------------------
  200.  
  201. If XXXXX is a feature of READ, you can probably change it. READ has a config
  202. file that's called READ.CFG (change this if